home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u359.dms / in.adf / FileLocator / FileLocator.Doc < prev    next >
Encoding:
Text File  |  1997-10-30  |  4.0 KB  |  102 lines
  1.       FileLocator © March 1, 1991, by Joe Rattz, Jr.
  2.             Published by JumpDisk Magazine
  3.  
  4. FileLocator will search devices for a particular file.
  5.  
  6. Up to 28 mounted devices will be displayed in a gadget list.  Any
  7. partcular device may be selected.  There is an ALL gadget to select
  8. all devices and a NONE gadget to deselect all devices.  If a disk
  9. drive is selected and there is not a disk in that drive, a prompt will
  10. be given.
  11.  
  12. When the START gadget is selected, FileLocator will search for the
  13. file name entered.  The following wildcards may be used:
  14.  
  15.   *filename -  will search for files that end with the entered
  16.          file name or string.
  17.    filename* - will search for files that begin with the entered
  18.          file name or string.
  19.   *filename* - will search for files that have the entered file
  20.          name or string in the middle.
  21.  
  22. More about wildcards:
  23.  
  24.   If "info" is entered and if it existed, the following file would
  25.      be listed:
  26.       "df0:c/info"
  27.  
  28.   If "*info" is entered and if they existed, the following files
  29.      would be listed:
  30.       "df0:c/info"
  31.       "df0:expansion.info" 
  32.  
  33.   If "info*" is entered and if they existed, the following files
  34.      would be listed:
  35.       "df0:c/info"
  36.       "df0:libs/info.library"
  37.  
  38.   If "*info*" is entered and if they existed, the following files
  39.      would be listed:
  40.       "df0:c/info"
  41.       "df0:expansion.info"
  42.       "df0:libs/info.library"
  43.       "df0:systems/doc.information"
  44.  
  45. File names may be entered in upper case or lower case or a combination
  46. of both.  FileLocator eliminates case sensitivity during the search.
  47.  
  48. When the START gadget is selected and the search begins, the START
  49. gadget converts into an ABORT gadget.  Select this gadget to stop the
  50. search at any time.  If the ABORT gadget is selected, the word
  51. "Aborted" is displayed.  If the START gadget is again selected, the
  52. search will not continue from the aborted point but from the first
  53. device.
  54.  
  55. During the search, the device then being searched will be displayed.
  56. When the search is completed, the word "Finished" will be displayed.
  57.  
  58. During the search, the running number of file comparisons made will be 
  59. displayed.  When the search is completed, the total number of file 
  60. comparisons will be displayed.
  61.  
  62. Any device file name(s) that match(es) the entered file name 
  63. (with or without wildcards) will be displayed along with the device
  64. name and/or directory name.  
  65.  
  66. During the search, the running number of matches between the entered
  67. file name and the device file name(s) will be displayed.  At the end
  68. of the search, the total number of matches will be displayed.
  69.  
  70. The Files Found display is 14 lines by 41 characters.  By scrolling,
  71. 145 lines by 200 characters are observable.  After 144 matches or
  72. lines, FileLocator will abort the search (ABORTED and BUFFER FULL will
  73. then be displayed).  Any lines longer than 200 characters will be
  74. truncated at 200 characters without any warning.  However any
  75. truncation should be obvious because part or all of the file name will
  76. not be displayed.
  77.  
  78. There is a HELP gadget that displays abbreviated instructions and an
  79. ABOUT gadget that displays the author, the publisher and ShareWare
  80. information.
  81.  
  82. WARNING: The STACK value for this program as set in the icon is 10000.
  83. (A stack value of 4000 will allow the program to freeze when a search
  84. progresses more than 11 directories deep).  If this program is run
  85. from the CLI, be sure to enter STACK 10000 prior to running
  86. FileLocator.  This is not necessary when the program is run from the
  87. icon.
  88.  
  89. This program is released through JUMPDISK magazine for the exclusive
  90. use of their readers until August 1, 1991.  On August 1, 1991, this
  91. program becomes ShareWare and may then be distributed to others.
  92. JUMPDISK magazine has paid a fee that authorizes the permanent use of
  93. this program by purchasers of their magazine.  Other users are
  94. requested to mail $5.00 USA to:
  95.  
  96.                          Joe Rattz, Jr.
  97.                          1051 Nottingham Drive
  98.                          Sumter, SC  29153-5186
  99.                          USA
  100.  
  101.                          Voice phone: (803) 778-2823
  102.